---
id: taskqueue
title: tctl v1.17 taskqueue command reference
sidebar_label: taskqueue
description: Try the new Temporal CLI public preview! Replace tctl with the v1.0 release. Use tctl taskqueue describe for Task Queue details and tctl taskqueue list-partition for partition info.
toc_max_heading_level: 4
keywords:
  - cli
  - cli reference
  - tctl
  - temporal
  - temporal cli
  - temporal server
---

:::info Temporal CLI is now available

The public preview of [Temporal CLI](/cli) is now available.
We encourage you to begin using it and to provide feedback.

After the release of Temporal CLI v1.0, tctl will deprecate.

:::

The `tctl taskqueue` command enables [Task Queue](/workers#task-queue) operations.

Alias: `t`

- [tctl taskqueue describe](#describe)
- [tctl taskqueue list-partition](#list-partition)

## describe

The `tctl taskqueue describe` command describes the poller information of a [Task Queue](/workers#task-queue).

`tctl taskqueue describe <modifiers> <value>`

The following modifiers control the behavior of the command.

### --taskqueue

_Required modifier_

Specify a [Task Queue](/workers#task-queue).

Alias: `--t`

**Example**

```bash
tctl taskqueue describe --taskqueue <value>
```

### --taskqueuetype

Specify the type of a [Task Queue](/workers#task-queue).
The type can be `workflow` or `activity`.
The default is `workflow`.

**Example**

```bash
tctl taskqueue describe --taskqueue <value> --taskqueuetype <type>
```

## list-partition

The `tctl taskqueue list-partition` command lists the partitions of a [Task Queue](/workers#task-queue) and the hostname for the partitions.

`tctl taskqueue list-partition --taskqueue <value>`

The following modifier controls the behavior of the command.

### --taskqueue

_Required modifier_

Specify a [Task Queue](/workers#task-queue) description.

Alias: `--t`

**Example**

```bash
tctl taskqueue list-partition --taskqueue <value>
```
